home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / jpegsrc4.zip / README < prev    next >
Text File  |  1992-12-10  |  22KB  |  402 lines
  1. The Independent JPEG Group's JPEG software
  2. ==========================================
  3.  
  4. README for release 4 of 10-Dec-92
  5. =================================
  6.  
  7. This distribution contains the fourth public release of the Independent JPEG
  8. Group's free JPEG software.  You are welcome to redistribute this software and
  9. to use it for any purpose, subject to the conditions under LEGAL ISSUES, below.
  10.  
  11. For installation instructions, see file SETUP.
  12.  
  13. For usage instructions, see file USAGE (or the cjpeg.1 and djpeg.1 manual
  14. pages; but USAGE contains a "hints" section not found in the manual pages).
  15. Useful information can also be found in the JPEG FAQ (Frequently Asked
  16. Questions) article; see ARCHIVE LOCATIONS below to obtain the FAQ article.
  17.  
  18. This software is still undergoing revision.  Updated versions may be obtained
  19. by FTP or UUCP to UUNET and other archive sites; see ARCHIVE LOCATIONS below
  20. for details.
  21.  
  22. Serious users of this software (particularly those incorporating it into
  23. larger programs) should contact jpeg-info@uunet.uu.net to be added to our
  24. electronic mailing list.  Mailing list members are notified of updates and
  25. have a chance to participate in technical discussions, etc.
  26.  
  27. This software is the work of Tom Lane, Philip Gladstone, Luis Ortiz,
  28. Lee Crocker, Ge' Weijers, and other members of the Independent JPEG Group.
  29.  
  30.  
  31. DISCLAIMER
  32. ==========
  33.  
  34. THIS SOFTWARE IS NOT COMPLETE NOR FULLY DEBUGGED.  It is not guaranteed to be
  35. useful for anything, nor to be compatible with subsequent releases, nor to be
  36. an accurate implementation of the JPEG standard.  (See LEGAL ISSUES for even
  37. more disclaimers.)
  38.  
  39. Despite that, we believe that this software is pretty good, and if you find
  40. any problems with it, we'd like to know about them.  Please report problems
  41. by e-mail to jpeg-info@uunet.uu.net.
  42.  
  43.  
  44. WHAT'S HERE
  45. ===========
  46.  
  47. This distribution contains C software to implement JPEG image compression and
  48. decompression.  JPEG (pronounced "jay-peg") is a standardized compression
  49. method for full-color and gray-scale images.  JPEG is intended for compressing
  50. "real-world" scenes; cartoons and other non-realistic images are not its
  51. strong suit.  JPEG is lossy, meaning that the output image is not necessarily
  52. identical to the input image.  Hence you must not use JPEG if you have to have
  53. identical output bits.  However, on typical images of real-world scenes, very
  54. good compression levels can be obtained with no visible change, and amazingly
  55. high compression levels are possible if you can tolerate a low-quality image.
  56. For more details, see the references, or just experiment with various
  57. compression settings.
  58.  
  59. The software implements JPEG baseline and extended-sequential compression
  60. processes.  Provision is made for supporting all variants of these processes,
  61. although some uncommon parameter settings aren't implemented yet.  For legal
  62. reasons, we are not distributing code for the arithmetic-coding process; see
  63. LEGAL ISSUES.  At present we have made no provision for supporting the
  64. progressive, hierarchical, or lossless processes defined in the standard.
  65.  
  66. In order to support file conversion and viewing software, we have included
  67. considerable functionality beyond the bare JPEG coding/decoding capability;
  68. for example, the color quantization modules are not strictly part of JPEG
  69. decoding, but they are essential for output to colormapped file formats or
  70. colormapped displays.  These extra functions can be compiled out if not
  71. required for a particular application.
  72.  
  73. The emphasis in designing this software has been on achieving portability and
  74. flexibility, while also making it fast enough to be useful.  In particular,
  75. the software is not intended to be read as a tutorial on JPEG.  (See the
  76. REFERENCES section for introductory material.)  While we hope that the entire
  77. package will someday be industrial-strength code, much remains to be done in
  78. performance tuning and in improving the capabilities of individual modules.
  79.  
  80.  
  81. This software can be used on several levels:
  82.  
  83. * As canned software for JPEG compression and decompression.  Just edit the
  84.   Makefile and configuration files as needed (see file SETUP), compile and go.
  85.   Members of the Independent JPEG Group will improve the out-of-the-box
  86.   functionality and speed as time goes on.
  87.  
  88. * As the basis for other JPEG programs.  For example, you could incorporate
  89.   the decompressor into a general image viewing package by replacing the
  90.   output module with write-to-screen functions.  For an implementation on
  91.   specific hardware, you might want to replace some of the inner loops with
  92.   assembly code.  For a non-command-line-driven system, you might want a
  93.   different user interface.  (Members of the group will be producing Macintosh
  94.   and Amiga versions with more appropriate user interfaces, for example.)
  95.  
  96. * As a toolkit for experimentation with JPEG and JPEG-like algorithms.  Most
  97.   of the individual decisions you might want to mess with are packaged up into
  98.   separate modules.  For example, the details of color-space conversion and
  99.   subsampling techniques are each localized in one compressor and one
  100.   decompressor module.  You'd probably also want to extend the user interface
  101.   to give you more detailed control over the JPEG compression parameters.
  102.  
  103. In particular, we welcome the use of this software as a component of commercial
  104. products; no royalty is required.
  105.  
  106.  
  107. ARCHIVE LOCATIONS
  108. =================
  109.  
  110. The "official" archive site for this software is ftp.uu.net (Internet
  111. address 137.39.1.9 or 192.48.96.9).  The most recent released version can
  112. always be found there in directory graphics/jpeg.  This particular version
  113. will be archived as jpegsrc.v4.tar.Z.  If you are on the Internet, you can
  114. retrieve files from UUNET by anonymous FTP.  If you don't have FTP access,
  115. UUNET's archives are also available via UUCP; contact postmaster@uunet.uu.net
  116. for information on retrieving files that way.
  117.  
  118. Numerous Internet sites maintain copies of the UUNET files; in particular,
  119. you can probably find a copy at any site that archives comp.sources.misc
  120. submissions.  However, only ftp.uu.net is guaranteed to have the latest
  121. official version.
  122.  
  123. You can also obtain this software from CompuServe, in the GRAPHSUPPORT forum
  124. (GO PICS), library 15; this version will be file jpsrc4.zip.  Again,
  125. CompuServe is not guaranteed to have the very latest version.
  126.  
  127. The JPEG FAQ (Frequently Asked Questions) article is a useful source of
  128. general information about JPEG.  It is updated constantly and therefore
  129. is not included in this distribution.  The FAQ is posted every two weeks
  130. to Usenet newsgroups comp.graphics, news.answers, and other groups.  You
  131. can always obtain the latest version from the news.answers archive at
  132. rtfm.mit.edu (18.172.1.27).  By FTP, fetch /pub/usenet/news.answers/jpeg-faq.
  133. If you don't have FTP, send e-mail to mail-server@rtfm.mit.edu with body
  134. "send usenet/news.answers/jpeg-faq".
  135.  
  136.  
  137. SUPPORTING SOFTWARE
  138. ===================
  139.  
  140. You will probably want Jef Poskanzer's PBMPLUS image software, which provides
  141. many useful operations on PPM-format image files.  In particular, it can
  142. convert PPM images to and from a wide range of other formats.  You can FTP
  143. this free software from export.lcs.mit.edu (contrib/pbmplus*.tar.Z) or
  144. ftp.ee.lbl.gov (pbmplus*.tar.Z).  Unfortunately PBMPLUS is not nearly as
  145. portable as the JPEG software is; you are likely to have difficulty making it
  146. work on any non-Unix machine.
  147.  
  148. If you are using X Windows you might want to use the xv or xloadimage viewers
  149. to save yourself the trouble of converting PPM to some other format.  Both of
  150. these can be found in the contrib directory at export.lcs.mit.edu.  Actually,
  151. xv version 2.00 and up incorporates our software and thus can read and write
  152. JPEG files directly.  (NOTE: since xv internally reduces all images to 8
  153. bits/pixel, a JPEG file written by xv will not be very high quality; and xv
  154. cannot fully exploit a 24-bit display.  These problems are expected to go away
  155. in the next xv release, planned for early 1993.  In the meantime, use
  156. xloadimage for 24-bit dis